# 🚀 GitHub Actions Workflow for .NET: `dotnet.yml`

Berikut adalah file workflow GitHub Actions untuk proyek .NET yang siap digunakan. Simpan file ini sebagai `.github/workflows/dotnet.yml` di repository Anda.

## 📁 Lokasi File
```
.github/workflows/dotnet.yml
```

## 📄 Isi File `dotnet.yml`

```yaml
name: .NET CI

# Kapan workflow ini dijalankan
on:
  push:
    branches: [ main, develop ]          # Jalankan pada push ke branch main/develop
  pull_request:
    branches: [ main ]                    # Jalankan pada PR ke branch main

jobs:
  build:
    runs-on: ubuntu-latest                 # Bisa juga windows-latest / macos-latest

    steps:
    # 1. Checkout kode dari repository
    - name: Checkout repository
      uses: actions/checkout@v4

    # 2. Setup .NET SDK
    - name: Setup .NET
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: 8.0.x               # Sesuaikan dengan versi .NET project Anda

    # 3. Restore dependencies (NuGet packages)
    - name: Restore dependencies
      run: dotnet restore

    # 4. Build project
    - name: Build
      run: dotnet build --configuration Release --no-restore

    # 5. Jalankan unit tests
    - name: Test
      run: dotnet test --configuration Release --no-build --verbosity normal
```

## 🔧 Fitur Tambahan (Opsional)

### **Caching NuGet Packages** (percepat build)
Tambahkan langkah ini setelah `actions/checkout`:

```yaml
    - name: Cache NuGet packages
      uses: actions/cache@v3
      with:
        path: ~/.nuget/packages
        key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj', '**/*.sln') }}
        restore-keys: |
          ${{ runner.os }}-nuget-
```

### **Matrix Build** (uji dengan beberapa versi .NET)
Ubah bagian `jobs` menjadi:

```yaml
jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        dotnet-version: [ '6.0.x', '7.0.x', '8.0.x' ]   # Versi yang akan diuji

    steps:
    - name: Checkout repository
      uses: actions/checkout@v4

    - name: Setup .NET ${{ matrix.dotnet-version }}
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: ${{ matrix.dotnet-version }}

    # ... langkah lainnya (restore, build, test) ...
```

### **Publish dan Upload Artifact** (hanya pada push ke main)
Tambahkan langkah ini setelah `Test`:

```yaml
    - name: Publish (hanya jika push ke main)
      if: github.ref == 'refs/heads/main' && github.event_name == 'push'
      run: dotnet publish --configuration Release --output ./publish

    - name: Upload artifact
      if: github.ref == 'refs/heads/main' && github.event_name == 'push'
      uses: actions/upload-artifact@v4
      with:
        name: my-app-${{ matrix.dotnet-version || '8.0.x' }}   # Nama file artifact
        path: ./publish
```

## ✅ Workflow Lengkap dengan Semua Fitur

```yaml
name: .NET CI/CD

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        dotnet-version: [ '6.0.x', '7.0.x', '8.0.x' ]

    steps:
    - name: Checkout repository
      uses: actions/checkout@v4

    - name: Cache NuGet packages
      uses: actions/cache@v3
      with:
        path: ~/.nuget/packages
        key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj', '**/*.sln') }}
        restore-keys: |
          ${{ runner.os }}-nuget-

    - name: Setup .NET ${{ matrix.dotnet-version }}
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: ${{ matrix.dotnet-version }}

    - name: Restore dependencies
      run: dotnet restore

    - name: Build
      run: dotnet build --configuration Release --no-restore

    - name: Test
      run: dotnet test --configuration Release --no-build --verbosity normal

    - name: Publish (hanya jika push ke main)
      if: github.ref == 'refs/heads/main' && github.event_name == 'push'
      run: dotnet publish --configuration Release --output ./publish

    - name: Upload artifact
      if: github.ref == 'refs/heads/main' && github.event_name == 'push'
      uses: actions/upload-artifact@v4
      with:
        name: my-app-${{ matrix.dotnet-version }}
        path: ./publish
```

## 📝 Catatan Penting

- Pastikan file workflow disimpan dengan ekstensi `.yml` (bukan `.yaml` – keduanya valid, tapi konsisten).
- Ganti `dotnet-version` sesuai dengan target framework project Anda (misal: `8.0.x`, `7.0.x`, `6.0.x`).
- Jika menggunakan Windows runner (`windows-latest`), perhatikan path cache dan command line.
- Untuk project yang menggunakan file `.sln` yang tidak berada di root, sesuaikan perintah `dotnet restore` dan `dotnet build` dengan path yang tepat (misal: `dotnet restore src/MySolution.sln`).

Setelah menambahkan file ini, commit dan push ke GitHub. Workflow akan otomatis berjalan. Cek tab **Actions** di repository Anda untuk melihat hasilnya.

Selamat mencoba! 🎉

Berikut adalah skrip **`dotnet-install.sh`** untuk memasang .NET SDK versi terkini (termasuk "Sazwan96 patch 2" – .NET 9.0.x). Skrip ini menggunakan sumber rasmi Microsoft.

---

### 📜 **dotnet-install.sh**
```bash
#!/bin/bash
# dotnet-install.sh – Pemasang .NET SDK untuk Sazwan96 patch 2 (Linux/macOS)

set -e

GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
CYAN='\033[0;36m'
NC='\033[0m' # No Color

echo -e "${CYAN}🚀 Memulakan pemasangan .NET SDK Sazwan96 patch 2...${NC}"

# Parameter (ubah suai mengikut keperluan)
CHANNEL="9.0"               # Saluran (9.0, STS, LTS)
VERSION="latest"            # "latest" atau versi spesifik seperti "9.0.102"
INSTALL_DIR="$HOME/.dotnet"
ARCHITECTURE="x64"

# Muat turun skrip pemasangan rasmi
echo -e "${YELLOW}📥 Memuat turun dotnet-install.sh dari Microsoft...${NC}"
curl -sSL https://dot.net/v1/dotnet-install.sh -o dotnet-install-tmp.sh
chmod +x dotnet-install-tmp.sh

# Jalankan pemasangan
echo -e "${YELLOW}⚙️  Menjalankan pemasangan .NET SDK (Channel: $CHANNEL, Version: $VERSION)...${NC}"
./dotnet-install-tmp.sh --channel $CHANNEL \
                        --version $VERSION \
                        --install-dir $INSTALL_DIR \
                        --architecture $ARCHITECTURE

if [ $? -eq 0 ]; then
    echo -e "${GREEN}✅ Pemasangan .NET SDK BERJAYA!${NC}"
    
    # Tambah ke PATH untuk sesi semasa
    export PATH="$INSTALL_DIR:$PATH"
    
    # Papar versi
    echo -e "${CYAN}🔍 Versi .NET yang dipasang:${NC}"
    $INSTALL_DIR/dotnet --info
else
    echo -e "${RED}❌ Pemasangan GAGAL! Sila semak log di atas.${NC}"
    exit 1
fi

# Bersihkan fail sementara
rm -f dotnet-install-tmp.sh

# Panduan tambahan
echo -e "${YELLOW}📌 Untuk menggunakan .NET secara global, tambahkan baris berikut ke ~/.bashrc atau ~/.zshrc:${NC}"
echo -e "   export PATH=\"\$PATH:$INSTALL_DIR\""
```

---

## ✅ **Cara Penggunaan**

1. **Simpan skrip** sebagai `dotnet-install.sh` dalam repositori Fairbase (misalnya di folder `scripts/`).
2. **Beri kebenaran untuk melaksanakan**:
   ```bash
   chmod +x dotnet-install.sh
   ```
3. **Jalankan**:
   ```bash
   ./dotnet-install.sh
   ```

### ⚙️ **Ubah Suai Parameter**
Anda boleh mengubah nilai pemboleh ubah dalam skrip:
- `CHANNEL`: Tukar kepada `"STS"`, `"LTS"`, atau versi lain seperti `"8.0"`.
- `VERSION`: Gunakan `"latest"` untuk patch terkini, atau nyatakan versi tepat seperti `"9.0.102"`.
- `INSTALL_DIR`: Tentukan direktori pemasangan pilihan.

---

## 🔗 **Integrasi dengan GitHub Actions**
Jika ingin memasang .NET dalam CI/CD, guna `actions/setup-dotnet@v4` seperti berikut:
```yaml
- name: Setup .NET
  uses: actions/setup-dotnet@v4
  with:
    dotnet-version: '9.0.x'   # auto ambil patch terkini
```

Skrip ini juga boleh digunakan dalam GitHub Actions dengan menjalankannya sebagai langkah shell.

---

## 📌 **Nota**
- Skrip ini sesuai untuk **Linux (Ubuntu, Debian, CentOS, dll.)** dan **macOS**.
- Untuk **Windows**, gunakan versi PowerShell yang telah disediakan sebelum ini (`dotnet-install-sazwan96.ps1`).

Jika ada sebarang masalah atau perlu penyesuaian, beritahu saya!